home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / util / cli / Randomizer.lha / ReadMeFirst < prev    next >
Text File  |  1997-04-05  |  3KB  |  77 lines
  1. Short introduction to Randomizer V1.0
  2. =====================================
  3.  
  4. 0. If you are not familiar in working with a shell, forget this program !!!
  5.  
  6. 1. Find the file Randomizer.
  7.  
  8. 2. Copy it to C: for your convenience.
  9.  
  10. 3. It takes 2 (optional) parameters: HI or HIGH, and LO or LOW. You can use
  11.    both the english or the american spelling, you can even mix it.
  12.  
  13.    a. HI/HIGH limits the random number to an upper bound. Do not overdo it,
  14.       it generates it's numbers from the timer ! You are totally safe, if
  15.       you keep it below 500 000 000, provided, your clock is set to the
  16.       actual time and not at some random value. It has a default value of
  17.       1 (one).
  18.  
  19.    b. LO/LOW raises the lower bound to the specified value. You NEVER get
  20.       a number below this value. If the timer generated a value below it,
  21.       it is lifted to this low value. Looking closer, this means, that there
  22.       is a much higher percentage of this low value, than of any other
  23.       number. If you use the LOW keyword, you BREAK the RANDOMNESS. By
  24.       default, it has a value of 0 (null), and I advise you, to leave it
  25.       there !
  26.  
  27. 4. Where is the number, then ? As the program is intended for use in scripts,
  28.    it seemed most convenient for me, to store it in a local shell variable.
  29.    So it creates a new variable by the name of "RANDOM", which holds the
  30.    random number. You can easily use it with "eval", tag it before or behind
  31.    filenames, and so on.
  32.  
  33. 5. How can I get rid of the number after use ? Simply type "Unset RANDOM" !
  34.  
  35. 6. Can you give me an example ? Yes, here it is. Let's say, you have a
  36.    backdrop picture located in SYS:Prefs/Patterns named "BackDropPic.iff".
  37.    Your WBPattern preferences settings include this path. Furthermore you
  38.    have 25 other pictures to be used as backdrops randomly, which are named
  39.    "picture.0" to "picture.24". Then you would write something like this in
  40.    your startup sequence:
  41.  
  42.    ...
  43.    C:AddDataTypes
  44.    ...
  45.  
  46.    ;example starts here
  47.  
  48.    C:Randomizer HIGH 24
  49.    C:Copy SYS:Prefs/Patterns/picture.$RANDOM SYS:Prefs/Patterns/BackDropPic.iff QUIET
  50.    Unset RANDOM
  51.  
  52.    ;example ends here
  53.  
  54.    ...
  55.    C:IPrefs
  56.    ...
  57.  
  58.    Please notice, that you would want to practise this example between the
  59.    AddDataTypes and IPrefs call !
  60.    Also note, that "Unset" is NOT A PROGRAM LOCATED IN C: !!! It is shell
  61.    private !
  62.    Further note, that the above example overwrites whatever the file
  63.    "BackDropPic.iff" is. If it was a 26th picture, you have lost it !
  64.  
  65. 7. I would kindly like to appreciate you to read the copyright files provided
  66.    in this archive. If there are none, DO NOT USE THE PROGRAM ! Mail me for
  67.    an original copy. I am releasing the sourcecode, too, so there might be
  68.    fakes or even viruses ! If in doubt, you can also download the original
  69.    archive at my homepage:
  70.  
  71.    http://home.t-online.de/home/T.Heinrich/homepage.htm
  72.  
  73. 8. Don't dump your Amiga. It still is the best home computer there is !
  74.  
  75. Thomas "Hoin" Heinrich
  76. April, 5th 1997
  77.